home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 2 / Amiga Tools 2.iso / tools / sasc_golded / sasc_golded.doc < prev    next >
Text File  |  1995-03-09  |  6KB  |  159 lines
  1.  
  2.                             SAS/C++ <=> GoldED V1.1
  3.                             ~~~~~~~~~~~~~~~~~~~~~~~~
  4.         Two AREXX scripts for embedding GoldED into SAS/C++ Environment.
  5.  
  6.                                        by
  7.                                 Roland Schwingel
  8.  
  9.  
  10.  
  11. Introduction
  12. ~~~~~~~~~~~~
  13. When developing a program one of the most anoying things is to get errors
  14. while compiling the program. And when you got no integrated environment
  15. it is also anoying to page through the file where the error occured
  16. manualy in order to track the bugs down.
  17.  
  18. GoldED is one of the best Editors around on the Amiga and SAS/C is also
  19. one of the best Compilers around. SAS/C offers an own integrated
  20. environment for his own Editor se (which isn't bad too, but awfully slow)
  21. and GoldEd normaly prefers DICE as compiler.
  22.  
  23. Fortunately both packages are offering an AREXX port. So it is not very
  24. hard to connect both. Now it is possible to invoke SAS/C from
  25. within GoldED and control occuring errors in an easy way.
  26.  
  27.  
  28. Disclaimer
  29. ~~~~~~~~~~
  30. These AREXX scripts are Freeware, but commercial use requires agreement
  31. by the author!
  32.  
  33. YOU ARE USING THESE SCRIPTS ENTIRELY AT YOUR OWN RISK ! THE AUTHOR
  34. CAN NOT BE MADE LIABLE FOR ANY HARM THIS SOFTWARE IS MAKING TO YOUR 
  35. SOFT- OR HARDWARE !
  36.  
  37.  
  38. Requirements
  39. ~~~~~~~~~~~~
  40. You will need the following things to run these scripts:
  41.  
  42. - GoldED 0.98 or better (propably it will also work with an older version)
  43.  
  44. - SAS/C++ V6.51 or better (should work with any SAS/C V6.x)
  45.  
  46. - installed AREXX
  47.  
  48. - an Amiga (of course)
  49.  
  50.  
  51. Installation
  52. ~~~~~~~~~~~~
  53.  
  54.   1. Copy the two AREXX scripts ('smake.ged' and 'scmsg_loadfile.ged')
  55.      to GOLDED:AREXX.
  56.  
  57.   2. Configure GoldED for invoking SAS/C from the editor:
  58.      Generate a keystroke and/or a menuitem which will
  59.      call the 'smake.ged' script with the following options.
  60.  
  61.      - set the commandtype (MX-Gadget) to ARexx and add the following 
  62.        line to the listview: 'GOLDED:ARexx/smake.ged'. You can also
  63.        add a smake parameter (like -u) after the name of the
  64.        scriptfile it will be passed to SMAKE. So you can
  65.        control the execution behavour of SMAKE. I got two
  66.        entries in my personal settings on two separate keys and menus.
  67.        'GOLDED:ARexx/smake.ged' invokes SMAKE in the normal way and
  68.        'GOLDED:ARexx/smake.ged -u' which will rebuild the whole project.
  69.  
  70.      - Set the output to: '"con:" \CON "/SMake/AUTO/SCREEN" \SCREEN'
  71.        (This field is the second stringgadget below the stringgadget
  72.        of the listview)
  73.        This will open a window in which you can watch the progress
  74.        of the compiler while compilation.
  75.  
  76.   3. Open the 'Message Options' Menu of the SCoptions Tool which is
  77.      part of the SAS/C-Package and set the 'ErrorRexx' Option. Save
  78.      this as default.
  79.  
  80.   4. At last configure the SCMSG utility which is also part of your
  81.      SAS/C Package. call SCMSG from the shell and select 'Set Options'
  82.      from the 'Project' menu. In the now appearing window set the 
  83.      following flags: 'NoHidden', 'NoRexxOnly' and 'NoAutoEdit'
  84.      Set the stringadgets to these values:
  85.  
  86.      - PortName:     GOLDED.1
  87.      - EditCommand:  ged %f
  88.                      (ged is the name of your GoldED Quickstarter)
  89.      - GotoFile:     rx CMD="GOLDED:Arexx/scmsg_loadfile %f %l"
  90.      - GoToLine:     <Leave this line empty; delete ALL letters in
  91.                      this stringgadget with your keyboard !!>
  92.      - PubScreen:    GOLDED.1
  93.  
  94.      Now select 'USE' and save these settings using the project menu.
  95.  
  96.      This archive contains my SCMSG config in the directory ENV. You can
  97.      copy it to ENVARC:sc (and ENV:sc).
  98.  
  99.  
  100. How it works
  101. ~~~~~~~~~~~~
  102. When you select your GoldED 'smake' menuitem or keystroke the 'smake.ged'
  103. AREXX script is executed and a window is opened. This script scans the 
  104. directory of the active filewindow for a MAKEFILE. When it finds one
  105. than 'SMAKE' is called with the parameters you have specified in your
  106. GoldED settings. When no makefile is found the script calls 'SC' with
  107. the filename of the active GoldEd window.
  108.  
  109. Now you can watch the progress of compilation in the new opened window.
  110. When an error occurs the SCMSG utility is automatically called and
  111. collects the errors. When compilation finishes you must hit return
  112. in the progress window.
  113.  
  114. If there were compile errors you can see them in the SCMSG window.
  115. Now you can select them with the mouse. In this moment the other AREXX
  116. script 'scmsg_loadfile.ged' is called. This script scans all GoldED
  117. windows for the file in which the error has occured and sets the cursor
  118. on the line with the error. If the file with the error is not in GoldED
  119. the file is loaded into GoldED first.
  120.  
  121. Unfortunately GoldED offers no access to its frozen windows via AREXX.
  122. When an error in a frozen window occurs the scriptfile tries to load it
  123. again in a new window.
  124.  
  125. Because of window interlocking do not doubleclick on an entry in the
  126. SCMSG window before compiling has finished and the smake window has
  127. been closed by you by hitting the return key. If you do so you will
  128. get an error due to the locked window.
  129.  
  130.  
  131. Contacting the Author
  132. ~~~~~~~~~~~~~~~~~~~~~
  133. You can reach me the following ways:
  134.  
  135.    Postal adress:
  136.  
  137.    Roland Schwingel
  138.    Lilienthalstraße 9
  139.    92421 Schwandorf
  140.    Germany
  141.  
  142.    Email:
  143.    roland.schwingel@extern.uni-regensburg.de
  144.  
  145.  
  146. History
  147. ~~~~~~~
  148.   22. Aug 1994  V1.0    Initial release. (But I am using these
  149.                         scripts for about 3 months now.)
  150.  
  151.   30. Aug 1994  V1.1    The V1.0 archive contained a wrong version
  152.                         of 'smake.ged'. It didn't set the path correct
  153.                         before compiling. The script that was included
  154.                         was a copy of my original script with which
  155.                         I made some experiments. Now the correct script
  156.                         is in the archive. Sorry for this. Archives
  157.                         shouldn't be made on midnight.
  158.  
  159.